package com.bt7274.mapper;

import com.bt7274.pojo.Permission;
import com.bt7274.pojo.User;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

import java.util.List;

/**
 * <p>
 * 用户表，保存本系统普通用户的基本信息 Mapper 接口
 * </p>
 *
 * @author hp,xyt
 * @since 2025-03-25
 */
public interface UserMapper extends BaseMapper<User> {
    public User selectUserById(String id);

    /**
     * 获取用户信息 by id
     * @param id User ID
     * @return User entity
     */
    User getUserById(@Param("id") String  id);

    /**
     * 获取用户信息 by username
     * @param username Username
     * @return User entity
     */
    User getUserByUsername(@Param("username") String username);

    /**
     * 获取用户信息 by email
     * @param email Email
     * @return User entity
     */
    User getUserByEmail(@Param("email") String email);

    /**
     * 更新用户个人信息
     * @param user User entity
     * @return Number of rows affected
     */
    int updateUser(User user);

    /**
     * 修改密码
     * @param userId User ID
     * @param password Encoded password
     * @return Number of rows affected
     */
    int updatePassword(@Param("userId") String userId, @Param("password") String password);

    /**
     * 更新用户状态
     * @param userId User ID
     * @param status New status
     * @return Number of rows affected
     */
    int updateStatus(@Param("userId") String userId, @Param("status") Integer status);

    /**
     * 更新用户权限组
     * @param userId User ID
     * @param permissionGroup New permissionGroup
     * @return Number of rows affected
     */
    int updatePermissionGroup(@Param("userId") String userId, @Param("permissionGroup") Integer permissionGroup);

    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户实体
     */
    User selectByUsername(@Param("username") String username);

    /**
     * 根据邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户实体
     */
    User selectByEmail(@Param("email") String email);

    /**
     * 根据用户名或邮箱查询用户
     *
     * @param usernameOrEmail 用户名或邮箱
     * @return 用户实体
     */
    User selectByUsernameOrEmail(@Param("usernameOrEmail") String usernameOrEmail);

    /**
     * 根据passkey查询用户
     *
     * @param passkey 用户密钥
     * @return 用户实体
     */
    User selectByPasskey(@Param("passkey") String passkey);

    List<User> selectUserList(User user);

}
